home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
asmutil
/
tbones07.zip
/
TBONES07.DOC
< prev
next >
Wrap
Text File
|
1991-01-20
|
18KB
|
405 lines
***************************************************************************
* *
* T-BONES *
* Version 0.7 *
* January 20, 1991 *
* *
* SKELETAL ASM PROGRAMS TO HELP IN PROGRAMMING YOUR OWN TSRs *
* *
* Copyright (C) 1990, 1991 by Robert Curtis Davis *
* *
* Internet E-mail address: sonny@trantor.harris-atd.com *
* *
* US Mail: 430 Bahama Drive *
* Indialantic, FL 32903 *
* *
***************************************************************************
ONE-LINE DESCRIPTION:
--------------------
TBONESxx.ZIP - Skeletal ASM programs for your own TSRs.
***************************************************************************
DISCLAIMER:
----------
T-BONES is currently under development and this is a preliminary
version. This software is not warranted to be suitable for any purpose and
the author will not be held responsible for any damages arising directly or
indirectly from its use. By the act of using this software, the user agrees
to these conditions.
***************************************************************************
DESCRIPTION:
-----------
T-BONES is a set of skeletal Assembly Language programs which
can be used as starting points in developing Terminate-but-Stay-
Resident (TSR) programs for your DOS computer.
BACKGROUND:
----------
In examining some software packages useful in learning about TSRs,
I couldn't seem to find one that provided skeletal ASM programs into
which I could easily drop my own Interrupt-triggered or Hot Key-triggered
routines. It was toward the provision of these bare-bones programs which
had already taken care of all the various details (initialization, saving
old interrupt vectors, installing new interrupt vectors, going resident,
determining if DOS code was interrupted, determining if DOS is at
"Busy idle", determining if the TSR is already installed, etc.) necessary
in some TSRs, that I undertook the writing of the programs in T-BONES
as an aid to my own TSR programming efforts.
Also, I recognized that not all the features enumerated are
necessary in every TSR. For example, if you are not going to use
DOS calls in your routine, checking to be sure DOS is at idle may be
unnecessary. Therefore, I have included TSRINT and TSRKEY which are
very simple and leave it up to you to stay out of DOS's way.
Anyway, it is my hope, based upon feedback from users, to provide
a set of useful skeletal TSR Assembly Language programs that
make it relatively easy for programmers to drop their own routines
into place without having to start all over from scratch on every TSR.
------------------------------------------
PERMITTED DISTRIBUTION AND USAGE OF TBONES:
No current restrictions are placed on the distribution either of the
TBONES package itself (please pass it on to anyone who might use it) or on TSRs
you might develop using this TBONES software package. But please leave
somewhere in your program an acknowledgement of TBONES' help in making the
TSR. Other than that, feel free to modify the ASM file (filename, comments,
output messages, TSR signature, etc.) to make it "look" and "feel" as you
wish.
------------------------------------------
TBONES' COST:
I presently ask only that you send me (preferably by E-mail) a free
copy of any generally-useful TSR that you develop using TBONES. That way,
I am paid in useful software only if TBONES itself proves genuinely useful
to you.
------------------------------------------------------------------------------
T-BONES currently consists of:
(1) README:
Quick start information. Read this to find out if TBONES
might be of use to you.
(2) TBONES07.DOC:
This complete documentation file.
(3) TSRINT.ASM:
Assembly Language skeletal program for use in
developing a TSR program that is triggered into
action by "Hooking" to a user-specified Interrupt.
Raw program with NO features to keep you out of
trouble with DOS nonreentrancy.
(4) TSRINT.COM:
Executable Hooked Interrupt TSR code obtained by
assembling TSRINT.ASM (with MASM), linking (with DOS'
LINK), and conversion from .EXE to .COM form using DOS'
EXE2BIN. The commands necessary to convert TSRINT.ASM
to TSRINT.COM are:
MASM TSRINT;
LINK TSRINT; (Ignore the No Stack warning)
EXE2BIN TSRINT TSRINT.COM
Or, if working with Borland's TASM package:
TASM /ml TSRINT
TLINK /x/t TSRINT
(5) TSRKEY.ASM:
Assembly Language skeletal program for use in
developing a TSR program that is triggered into
action by a user-specified "Hot Key" combination.
Raw program with NO features to keep you out of
trouble with DOS nonreentrancy.
(6) TSRKEY.COM:
Executable HotKey TSR code obtained by assembling
TSRKEY.ASM (with MASM), linking (with DOS' LINK), and
conversion from .EXE to .COM form using DOS'
EXE2BIN. The commands necessary to convert TSRKEY.ASM
to TSRKEY.COM are:
MASM TSRKEY.ASM;
LINK TSRKEY.OBJ;
EXE2BIN TSRKEY.EXE TSRKEY.COM
Or, if working with Borland's TASM package:
TASM /ml TSRKEY
TLINK /x/t TSRKEY
(7) TSRBONES.ASM:
TSRBONES is the flagship program in this package.
It is an Assembly Language skeletal program for use in
developing a TSR program that is triggered into
action by a user-specified "Hot Key" combination
WHEN DOS IS AT "BUSY IDLE" Int 28h. When DOS is
at "Busy Idle", it is safe to use DOS Function calls
ABOVE 0Ch without incurring problems with DOS'
non-reentrancy. The code also prevents multiple
installations. The TSR also will not trigger if the CPU
is busy servicing a hardware interrupt (IRQ0 - IRQ7).
(8) TSRBONES.COM:
Executable HotKey "DOS-OK" TSR code obtained by
assembling TSRBONES.ASM (with MASM), linking (with
DOS' LINK), and conversion from .EXE to .COM form
using DOS' EXE2BIN. The commands necessary to convert
TSRBONES.ASM to TSRBONES.COM are:
MASM TSRBONES.ASM;
LINK TSRBONES.OBJ;
EXE2BIN TSRBONES TSRBONES.COM
Or, if working with Borland's TASM package:
TASM /ml TSRBONES
TLINK /x/t TSRBONES
(9) HISTORY:
The revision history for the TBONES package.
******************************************************************************
ASSEMBLERS:
The following assemblers are known to successfully assemble the
ASM files in TBONES:
- ARROWSOFT Public Domain Assembler v1.00d (64K Model)
- MASM v1.0 and v4.00
- TASM v1.00
********************************************************************